For more information about DoubleCommand please visit http://homepage.mac.com/mbaltaks/doublecommand/

Welcome to DoubleCommand!
By Michael Baltaks <mbaltaks@mac.com>
DoubleCommand 1.3

About DoubleCommand

DoubleCommand is a Mac OS X 10.1 kernel extension that lets you remap certain keys to certain other keys. It started out as a quick way to turn the Enter key into a Command key, but is now far more powerful than every before.

DoubleCommand started out as a hack of iJect, which was generously GPL'd by Christian Starkjohann. So go check out the great software he makes over at Objective Development <http://www.obdev.at/>

As a result, DoubleCommand is released under v2 of the GPL. Please read the file Licence.txt for more information.

Installing DoubleCommand on Mac OS X 10.1

To install DoubleCommand, please perform the following steps:

1.	Remove any older versions of DoubleCommand, iJect, uControl or PowerDelete (see below for how to do that). These are conflicting software.

2.	Open a Finder window and go to the "Library" folder directly on your Mac OS X startup volume. (There are several folders named "Library". We mean the one in the root of the startup volume, NOT in the System folder!)

3a. If there is a folder named "StartupItems", drop the "DoubleCommand" folder into it. The DoubleCommand folder is in the "StartupItems" folder in the distributed disk image.
3b. If there is no such folder, drop the whole folder "StartupItems" from the distributed disk image directly into the "Library" folder.
	You should have created a directory hierarchy like this in any case:

	/Library/StartupItems/DoubleCommand

4.	Restart the computer

After rebooting, DoubleCommand will be active.

Note: You need Administrator rights to install startup items, but you do not need to be the Unix super user "root". The user account which is created during installation of the operating system has administrator rights.

Configuring DoubleCommand

To configure DoubleCommand requires some basic maths ability and a text editor (like this one). You only need to edit the file /Library/StartupItems/DoubleCommand/DoubleCommand, changing the number at the end of the line:
/usr/sbin/sysctl -w dc.config=1
to a number calculated below and save the file. Then either copy that line into a Terminal and press return, or just restart your computer.

The table below shows a list of numbers and what functionality they activate. To activate more than one at a time, simply add the numbers together. For example, I like enter -> command and shift+delete -> forward delete, so I use 1 + 16384 = 16385. So my file has a line that looks like:
/usr/sbin/sysctl -w dc.confi=16385

Where command, option, etc are used it means any command, option, etc keys on your keyboard. It is not possible at this stage to only change for example the right option key to something else, you must change both option keys. This issue is under investigation, and will be included in any versions released for Mac OS X 10.2 (Jaguar).

0 - do nothing
1 - enter -> command
2 - enter -> control
4 - enter -> option
8 - enter -> fn (partial support, cursor keys only)
16 - command -> option
32 - command -> control
64 - option -> command
128 - option -> fn (not yet available)
256 - control -> command
512 - control <-> option (swap)
1024 - control -> fn (not yet available)
2048 - caps lock -> control (partial, sticky)
4096 - fn -> control
8192 - numpad . switch
16384 - shift delete -> forward delete
32768 - disable option and command

Removing DoubleCommand

To remove DoubleCommand from your machine:

1.	Delete the DoubleCommand folder in /Library/StartupItems on your Mac OS X  startup volume.

2.	Restart your computer.

Removing conflicting software

To remove conflicting software from your machine:

1.	Delete the iJect, uControl or PowerDelete folder in /Library/StartupItems on your Mac OS X  startup volume.

2.	Restart your computer.

Troubleshooting

DoubleCommand has been developed for Mac OS X 10.1. It is known to run on Mac OS X 10.1.0 through to 10.1.5 and probably runs on later versions, too. However, since it links to internal kernel structures, newer versions of the kernel may break DoubleCommand. In particular, there are separate binaries for 10.1.0 - 10.1.4 and 10.1.5.

If your machine does not boot after installing DoubleCommand, hold the option (alt) key during booting and boot to Mac OS 9. You can remove DoubleCommand from Mac OS 9.

Version History

1.3 - 2002-07-19: Code tidy and added capslock -> control and other features.

1.3b2 - 2002-06-06: Fixed a kernel panic with Mac OS X 10.1.5.

1.3b1 - 2002-05-01: All versions joined into one, now configurable at any time!

1.2.2 - 2001-12-15: Removed Shift-F12 option since it interferes with the Shift+Delete feature.

1.2.1 - 2001-10-23: Fixed problem with Deluxe that blocked the Command+Shift+Delete empty trash key shortcut.

1.2 - 2001-10-22: Added Shift-Delete feature, split into standard and deluxe versions.

1.1 - 2001-10-21: Fixed keyboard bell and enter key event problem. Fixed Command-Tab problem. Fixed page jump problem in BBEdit.

1.0 - 2001-10-16: Initial release.
_________________________________________
Copyright © 2001-2002, Michael Baltaks.